home *** CD-ROM | disk | FTP | other *** search
/ SGI Desktop Special Edition 1.0 / SGI Desktop Special Edition 1.0.iso / relnotes / patchSG0000700 / ch1.z / ch1
Text File  |  1995-09-11  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        1.  _P_a_t_c_h__S_G_0_0_0_0_7_0_0__R_e_l_e_a_s_e__N_o_t_e
  9.  
  10.        This release note describes patch SG0000700 to IRIX 5.3 with
  11.        XFS.
  12.  
  13.        1.1  _W_a_r_n_i_n_g
  14.  
  15.        This patch changes the format of some of the data written to
  16.        the log of XFS file systems.  Because of this and the fact
  17.        that XFS root file systems are not unmounted cleanly in the
  18.        system shutdown process, this patch must not be removed once
  19.        it has been installed and an XFS file system has been used
  20.        for the root file system.  For non-root file systems, it
  21.        will be possible to remove the patch as long as the file
  22.        systems are unmounted cleanly before doing so.  If these
  23.        restrictions are not followed and the patch is removed, it
  24.        will not be possible to mount the XFS file systems using the
  25.        kernel not containing the patch.
  26.  
  27.        This means that if you have loaded this patch and have an
  28.        XFS root filesystem, the standard IRIX 5.3 with XFS
  29.        installation tools found on the IRIX 5.3 with XFS CD (p/n
  30.        813-0323-001) will not work properly.  Specifially, the root
  31.        filesystem will not be able to be mounted.  Therefore, it is
  32.        imperative that you save the installation tools that you
  33.        received with this patch for use at a later date.  Note that
  34.        this restriction will be lifted at the next release of the
  35.        operating system.
  36.  
  37.        1.2  _S_u_p_p_o_r_t_e_d__H_a_r_d_w_a_r_e__P_l_a_t_f_o_r_m_s
  38.  
  39.        This patch contains bug fixes for the following machine
  40.        types.  The software cannot be installed on other
  41.        configurations:
  42.  
  43.           +o Challenge and Onyx with R4400 processors
  44.  
  45.           +o Crimson (4D/510)
  46.  
  47.           +o PowerSeries (4D/120, 4D/2xx, 4D/3xx and 4D/4xx)
  48.  
  49.           +o Indigo and Indigo2
  50.  
  51.           +o Indy
  52.  
  53.        1.3  _S_u_p_p_o_r_t_e_d__S_o_f_t_w_a_r_e__P_l_a_t_f_o_r_m_s
  54.  
  55.        This patch contains bug fixes for IRIX 5.3 with XFS.  The
  56.        software cannot be installed on other configurations.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        1.4  _B_u_g_s__F_i_x_e_d__b_y__P_a_t_c_h__S_G_0_0_0_0_7_0_0
  75.  
  76.        This patch contains fixes for the following bugs in IRIX 5.3
  77.        with XFS.  Bug numbers from Silicon Graphics bug tracking
  78.        system are included for reference.
  79.  
  80.           +o There is a very slight chance that the kernel could
  81.             panic when an XFS file system becomes full (bug
  82.             254266).
  83.  
  84.           +o The implementation of the Data Management API is
  85.             incomplete in 5.3 with XFS.  This patch includes the
  86.             pieces which were missing (bug 258113).
  87.  
  88.           +o XFS file systems with small block sizes perform badly
  89.             on operations which scan large numbers of inodes, e.g.
  90.             du or find.  This patch alters XFS to use larger
  91.             buffers for reading, writing, and caching inodes in
  92.             small blocks size file systems (bug 259540).
  93.  
  94.           +o A process reading from a file in an XFS file system
  95.             using direct I/O could panic the system if it reads
  96.             beyond the end of the file (bug 260200).
  97.  
  98.           +o When it encounters an error, xfs_growfs (actually the
  99.             syssgi(XFS_FSOPERATIONS) code supporting it) leaves the
  100.             buffer for the disk block which encountered the error
  101.             locked.  Any subsequent attempts to run xfs_growfs will
  102.             become stuck waiting for that buffer to be unlocked
  103.             (bug 261003).  If this problem occurs using XLV to grow
  104.             the volume containing the file system, the fix for XLV
  105.             in patch 301 will very likely be required as well.
  106.  
  107.           +o Processes trying to read an XFS file at a constant rate
  108.             will sometimes encounter delays in the time it takes
  109.             for a read to complete.  This is due to interference
  110.             from the periodic file system sync process and a
  111.             problem with the file cache taking too much memory.
  112.             This patch fixes the sync problem, and the file cache
  113.             problem is fixed in patch 288 (bug 261228).
  114.  
  115.           +o The xfs_check utility would core dump under certain
  116.             conditions on an unrecovered file system (bug 261860).
  117.  
  118.           +o Performing a file create system call on an XFS file
  119.             system root directory or the ".." entry of an XFS
  120.             directory would cause the process to hang indefinitely.
  121.             Other processes trying to traverse that directory would
  122.             become hung as well (bug 263205).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.           +o The NFS server implementation in Irix did not return
  141.             any value in the microseconds field for the modify time
  142.             on the return from a getattr call (rfe 251693).
  143.  
  144.           +o The XFS code can panic complaining that a log
  145.             reservation has come up short (bug 270243).
  146.  
  147.           +o Doing an 'ls' of small XFS directories over NFS can
  148.             fail from some other companies' NFS clients.  This
  149.             causes the directory to appear empty or for 'ls' to
  150.             return errors from those client machines (bug 260747).
  151.  
  152.           +o When using DIRECT_IO to read an XFS file, where the
  153.             size of the file is not an even multiple of 512 bytes,
  154.             an error will occur when trying to read the last block
  155.             of the file. The read system call will return an error
  156.             or the process will hang (bug 274423).
  157.  
  158.           +o After booting a new kernel with added or deleted
  159.             filesystems, NFS clients may get bogus filehandle or
  160.             stale filehandle messages.  For example, adding the
  161.             NFS3 filesystem or deleting the efs filesystem can
  162.             cause the problem (bug 274345, 278660)
  163.  
  164.           +o The DMAPI event state isn't cleared in the on-disk
  165.             inode when a file is removed.  When an inode is reused,
  166.             the new file may already have DMAPI events enabled.
  167.             (bug 275732)
  168.  
  169.           +o The file system might not recover correctly after a
  170.             crash.
  171.  
  172.           +o Small, synchronous writes to an XFS file were
  173.             particularly slow.  This has been fixed by reducing the
  174.             amount of unnecessary I/O done for each write (bug
  175.             268182).
  176.  
  177.           +o The filesystem will crash the kernel when looking up an
  178.             entry in a corrupted directory.  While directories are
  179.             not supposed to become corrupted, this can happen due
  180.             to disk failures or XFS recovery bugs.  With this fix
  181.             references to such entries will return errors rather
  182.             than crashing the system (bug 271325).
  183.  
  184.           +o If an NFS client performs a directory lookup using a
  185.             file which is not a directory, the system will crash or
  186.             return incorrect results.  The problem is not possible
  187.             if the NFS client is an SGI machine running a recent
  188.             release (bug 278247).
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.           +o The system could crash due to a race condition in the
  207.             XFS transaction code for managing kernel buffers (bug
  208.             252383).
  209.  
  210.           +o Installing patch 538 caused direct I/O to XFS files to
  211.             stop working (bug 282906).
  212.  
  213.           +o The filesystem will sometimes crash the kernel in the
  214.             xfs_trans_chunk_committed() routine (bug 283739).
  215.  
  216.           +o Programs calling msync(2) or fsync(2) on files residing
  217.             in XFS filesystems would sometimes hang for up to 10
  218.             seconds before returning from the system call (bug
  219.             283854).
  220.  
  221.           +o XFS can sometimes crash in the transaction code due to
  222.             a race condition in the log callback code (bug 275579).
  223.  
  224.           +o XFS can sometimes appear to freeze up for no reason
  225.             (bug 285600).
  226.  
  227.           +o XFS can become deadlocked when there is a very large
  228.             amount of inode update activity (bug 290906).
  229.  
  230.           +o Writes to XFS files using direct I/O do not return
  231.             errors properly when something is wrong.  Instead,
  232.             small random values are returned (bug 291541).
  233.  
  234.           +o Doing direct I/O writes to a file with pending buffered
  235.             writes can cause the direct I/O writes to fail (bug
  236.             291544).
  237.  
  238.        1.5  _S_u_b_s_y_s_t_e_m_s__I_n_c_l_u_d_e_d__i_n__P_a_t_c_h__S_G_0_0_0_0_7_0_0
  239.  
  240.        This patch release includes these subsystems:
  241.  
  242.           +o patchSG0000700.eoe2_sw.xfs
  243.  
  244.  
  245.        1.6  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_s_t_r_u_c_t_i_o_n_s
  246.  
  247.        Because you want to install only the patches for problems
  248.        you have encountered, patch software is not installed by
  249.        default. After reading the descriptions of the bugs fixed in
  250.        this patch (see Section 1.3), determine the patches that
  251.        meet your specific needs.
  252.  
  253.        If, after reading Sections 1.1 and 1.2 of these release
  254.        notes, you are unsure whether your hardware and software
  255.        meet the requirements for installing a particular patch, run
  256.        _i_n_s_t.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        Patch software is installed like any other Silicon Graphics
  273.        software product.  Follow the instructions in your _S_o_f_t_w_a_r_e
  274.        _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e to bring up the miniroot
  275.        form of the software installation tools.
  276.  
  277.        Follow these steps to select a patch for installation:
  278.  
  279.          1.  At the Inst>prompt, type
  280.  
  281.              iiiinnnnssssttttaaaallllllll ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  282.  
  283.              where _x_x_x_x_x_x_x is the patch number.
  284.  
  285.          2.  Select the desired patches for installation.
  286.  
  287.          3.  Initiate the installation sequence. Type
  288.  
  289.              IIIInnnnsssstttt>>>> ggggoooo
  290.  
  291.          4.  You may find that two patches have been marked as
  292.              incompatible.  If this occurs, you must deselect one
  293.              of the patches.
  294.  
  295.              IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  296.  
  297.              where _x_x_x_x_x_x_x is the patch number.
  298.  
  299.          5.  After completing the installation process, exit the
  300.              _i_n_s_t program by typing
  301.  
  302.              IIIInnnnsssstttt>>>> qqqquuuuiiiitttt
  303.  
  304.  
  305.        To remove a patch, use the _v_e_r_s_i_o_n_s _r_e_m_o_v_e command as you
  306.        would for any other software subsystem.  The removal process
  307.        reinstates the original version of software unless you have
  308.        specifically removed the patch history from your system.
  309.  
  310.        vvvveeeerrrrssssiiiioooonnnnssss rrrreeeemmmmoooovvvveeee ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  311.  
  312.        where _x_x_x_x_x_x_x is the patch number.
  313.  
  314.        To keep a patch but increase your disk space, use the
  315.        _v_e_r_s_i_o_n_s _r_e_m_o_v_e_h_i_s_t command to remove the patch history.
  316.  
  317.        vvvveeeerrrrssssiiiioooonnnnssss rrrreeeemmmmoooovvvveeeehhhhiiiisssstttt ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  318.  
  319.        where _x_x_x_x_x_x_x is the patch number.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.